简介

概述

数据中台是一个集成了设备管理、数据安全通信、消息订阅和数据服务等能力的一体化平台。向下支持连接海量设备，采集设备数据上云；向上提供云端API，服务端可通过调用云端API将指令下发至设备端，实现远程控制。本文档指导您如何操作 Neuron 数据中台，以接入并管理各类设备与数据。完成接入后，您便可对实时与历史数据进行深入分析，并创建直观的可视化报表，从而提高管理效率。

产品功能

设备接入： 设备接入流程是 Neuron 数据中台的核心环节之一，为用户提供了一条清晰的规范化路径，依次完成预配置、通信方式选择、设备注册与标签管理，实现设备的顺利对接。
设备管理： 设备管理模块是数据中台的核心功能模块之一，是设备的一站式管理中枢，用户可在此完成从搜索、信息维护到告警配置的全生命周期操作。
设备反控： 设备反控模块支持用户通过远程指令操控已接入的设备，借助物模型控制点位配置、设备来源定义及个性化指令设置，实现精准的设备远程操控功能。
OpenAPI 指南： 通过调用 OpenAPI 这一便捷工具，开发者可以连接外部系统与数据中台，建立安全、自动化的设备数据采集、查询与分析流程。

访问方式与先决条件

如何访问

数据中台提供以下两种访问途径：

Web门户访问：通过浏览器访问官方URL，使用您的账号直接登录。
API程序化访问：通过调用平台提供的RESTful API进行集成与开发。此方式需要您先在数据中台内或向管理员申请有效的API令牌。

登录成功后，选择需操作的项目，项目数据资源相互隔离。 project

在项目详情页，点击应用列表/右边栏的数据中台进入应用。 project_detail

进入数据中台首页。

开始之前

权限配置

为确保正常访问与功能使用，您的账号需要被邀请进入项目且拥有查看数据中台应用的权限。若没有请联系项目管理员, 或参考【邀请成员加入项目】/【安装并配置权限】。

前置配置

设备准备：

传统设备(非IoT)：需处于在线状态，支持标准工业协议（BACnet、Modbus等—— 具体协议类型需与设备厂商确认）；
IoT设备：需根据接入方式完成前置配置。

设备接入：

LoRaWAN NS 接入：设备需支持 LoRaWAN 协议，已在 ChirpStack/Netmore 等平台注册，获取 DevEUI、AppId；
MQTT 接入：设备需完成网络接入（Wi-Fi、以太网），支持 MQTT 协议，记录设备唯一标识（IMEI/Device SN）；
API 接入：设备需支持 HTTP/HTTPS 协议，具备数据上报接口，获取设备认证令牌（Token）；
蓝牙接入：设备需支持蓝牙 4.0+（BLE），处于数据中台蓝牙网关覆盖范围，记录设备蓝牙 MAC 地址。

文档准备：

非 IoT 设备：收集设备ID、IP地址、端口号、设备地址、工业协议参数及数据字典（如 “HVAC-1-Temp” 代表 1 号暖通空调的温度点位）；
IoT 设备：
- LoRaWAN NS：收集 ChirpStack/Netmore 平台地址、租户 ID、应用 ID、DevEUI、AppID；
- MQTT：收集MQTTBroker 地址、端口、订阅 Topic、认证信息（用户名 / 密码 / 证书）；
- API：收集设备上报URL、请求方法（POST/GET）、认证令牌、数据格式（JSON/XML）；
- 蓝牙：收集设备蓝牙 MAC 地址、广播间隔、数据解析协议（如蓝牙 SIG 规范）、蓝牙网关ID。

可参考《传统设备连接指南》《IoT 设备四种接入方式配置手册》进行设备前置配置 —— 请注意，不同接入方式、不同厂商设备的具体配置步骤可能存在差异。

名词解释

非IoT设备：传统楼宇管理设备，以有线连接为主，支持工业协议（BACnet、Modbus），无联网交互能力（如传统 HVAC、有线照明控制器）；

IoT设备：具备联网/短距通信能力的智能楼宇设备，支持LoRaWAN、MQTT、API、蓝牙等接入方式，可实时上传数据（如智能传感器、无线温控器）；

设备反控：平台向已接入的设备发送控制指令，实现对设备的远程操作功能。

LoRaWAN NS（Network Server）：LoRaWAN 网络的核心组件，负责管理LoRaWAN设备、转发设备数据，主流平台包括 ChirpStack（开源）、Netmore（商用）等；

物模型：在 Neuron 平台中，某一类具有相同能力或特征的设备的合集被称为一款物模型。例如: 室内环境监测传感器--> 可以定义物模型为IAQ, Function type(数据点位)包含Temperature / Humidity。

MQTT：轻量级物联网通信协议，基于发布-订阅模式，适用于低带宽、高延迟场景的IoT设备数据传输；

API接入：设备通过 HTTP/HTTPS 接口直接向数据中台上报数据，适用于具备自主通信能力的设备；

蓝牙接入：IoT设备通过BLE（低功耗蓝牙）与移动APP通信，通过APP将数据接入数据中台，适用于短距离、低功耗场景（如室内传感器）；

数据源：楼宇数据的来源，包括非IoT设备、IoT设备（四种接入方式）及第三方系统（能耗管理系统、物业管理系统）；

数据处理规则：对原始数据（非IoT/IoT设备数据）进行清洗、转换、聚合的规则（如过滤异常温度值、计算日平均能耗）；

数据服务API：供外部系统（如运营仪表盘、移动端APP）调用数据中台数据的标准化接口，支持查询和订阅模式；

数据仪表盘：以图表（折线图、柱状图、仪表盘）形式展示楼宇关键指标（如设备运行状态、能耗趋势）的可视化界面；

时序数据库（TSDB）：数据中台的底层存储引擎，专门用于存储高频非IoT设备与IoT设备时序数据（如 1 分钟间隔的温度数据）；

时序数据：一系列带时间戳的数据点，用于描述设备在特定时间点的状态或测量值。它是物联网领域最常见的数据类型；

数仓数据：存储在数据仓库中的、通常经过清洗、聚合后的业务数据或主数据，可用于更复杂的分析和报表；

Topic：在 MQTT 协议中，Topic 是一个用于寻址和过滤消息的UTF-8字符串。它充当了消息发布者（Publisher）与订阅者（Subscriber）之间的虚拟消息通道，是实现消息路由的核心机制；

Topic类别区别详解：

特性	精确匹配	通配符匹配
定义	一个完整的、确定的主题名，与发布的消息主题完全一致才能匹配	一个包含特殊字符的主题过滤器，用于匹配一类主题
使用场景	主要用于发布消息。也可以用于订阅，但只能订阅一个特定主题	仅用于订阅，不能用于发布消息
包含字符	只允许主题层级分隔符 `/` 和普通的UTF-8字符，不能包含 `+` 和 `#`	除了普通字符和 `/`，还包含单层通配符 `+` 和多层通配符 `#`
匹配规则	逐级精确相等	`+` 匹配一个完整的层级；`#` 匹配任意数量（包括0个）的层级，且必须是过滤器的最后一个字符
示例主题	application/app_001/device/dev_123/event/up	application/+/device/+/event/up

ETL转换器：数据中台将设备上报的多样化、非标准数据格式，转换为平台能够统一识别和处理的标准化数据格式的核心组件；

RSA令牌：基于非对称加密算法的API认证凭证，采用公钥加密、私钥解密的机制确保数据传输安全；

JWT令牌：基于JSON的开放标准令牌，采用数字签名确保令牌的完整性和可信度。

简介

概述​

产品功能​

访问方式与先决条件​

如何访问​

开始之前​

权限配置​

前置配置​

名词解释​

概述